home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / SWMAG / DISK3485.ZIP / ZCE.DOC < prev    next >
Text File  |  1991-06-04  |  38KB  |  1,181 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                         Zip Comment Editor and Zip Directory
  14.                         =----------------------------------=
  15.  
  16.  
  17.                                    Users's Guide
  18.  
  19.                                     Version 1.1
  20.  
  21.                                     June 3, 1991
  22.  
  23.  
  24.  
  25.                               Copyright (C) 1990, 1991
  26.  
  27.                                          by
  28.  
  29.                                  Michael D. Boling
  30.  
  31.  
  32.                                 All Rights Reserved
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. COPYRIGHT NOTICE
  66.  
  67.          ZCE & ZD Version 1.1
  68.  
  69.          Copyright (c) 1990, 1991 by Michael D. Boling All Rights Reserved.
  70.  
  71.          Zip Comment Editor (ZCE) and companion program Zip Directory (ZD)
  72.          allow editing and viewing of Zip file Comments.
  73.  
  74.          ZCE and ZD have been released as shareware.  This means the
  75.          version you have is fully functional.  It also means that within
  76.          30 days you decide to use ZCE or ZD, you are obligated to pay a
  77.          licensing fee or stop using them.
  78.  
  79.          ZCE and ZD are copyrighted and may be distributed only under the
  80.          following conditions:
  81.  
  82.          No fee of over $10.00 may be charged for distribution.  This
  83.          restriction applies only to physical copies and is not meant to
  84.          prevent distribution by telecommunication services.
  85.  
  86.          All ZCE files must be distributed together in original, unaltered
  87.          form.  This includes ZCE.EXE, ZD.EXE, ZCE.DOC, ZCE.NEW, ZCE.HLP,
  88.          FILES.LST and REGISTER.TXT.
  89.  
  90.          You may use these programs at your own risk.  They have been
  91.          tested by me on my own computer, but I will not assume any
  92.          responsibility for any problems which ZCE or ZD may cause you.  If
  93.          you do encounter a problem, please let me know about it, and I
  94.          will do my best to verify and repair the error.
  95.  
  96.  
  97. LIMITED WARRANTY
  98.  
  99.          THE PROGRAMS CONTAINED IN THIS PACKAGE ARE PROVIDED "AS IS"
  100.          WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
  101.          INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  102.          MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE
  103.          RISK RELATED TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS ON
  104.          YOU.  IN THE EVENT THERE IS ANY DEFECT, YOU ASSUME THE ENTIRE COST
  105.          OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.  SOME STATES DO
  106.          NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE
  107.          EXCLUSION MAY NOT APPLY TO YOU.  THIS WARRANTY GIVES YOU SPECIFIC
  108.          LEGAL RIGHTS WHICH VARY FROM STATE TO STATE.
  109.  
  110.          It is expected that if you find ZCE and ZD useful, you must
  111.          register your copy.  Registration entitles you to receive
  112.          information to remove trailing banners for this and one future
  113.          version of ZCE and ZD.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.     Table of Contents
  126.  
  127.           What are ZCE and ZD?  . . . . . . . . . . . . . .     1
  128.           ZCE Features  . . . . . . . . . . . . . . . . . .     2
  129.           ZD Features . . . . . . . . . . . . . . . . . . .     2
  130.           Limitations of ZCE and ZD . . . . . . . . . . . .     2
  131.           ZCE & ZD System Requirements  . . . . . . . . . .     2
  132.           ZCE & ZD Document Information . . . . . . . . . .     2
  133.           Using ZCE <Zip Comment Editor>  . . . . . . . . .     3
  134.           ZCE Command Line Examples . . . . . . . . . . . .     3
  135.           ZCE Command line switches . . . . . . . . . . . .     4
  136.           ZCE Command Line Display Options  . . . . . . . .     4
  137.           ZCE Environment Variable  . . . . . . . . . . . .     4
  138.           Example ZCE Screen  . . . . . . . . . . . . . . .     5
  139.           ZCE Main Window Editing Keys  . . . . . . . . . .     6
  140.           ZCE Commands  . . . . . . . . . . . . . . . . . .     6
  141.           F1 = On Line Help Window Functions  . . . . . . .     6
  142.           Mouse Help Window Functions . . . . . . . . . . .     6
  143.           F2 = Re-Read Zip Comments . . . . . . . . . . . .     7
  144.           F3 = Write Zip Comments . . . . . . . . . . . . .     7
  145.           F4 = New File Specification & Read Comments . . .     7
  146.           F5 = Copy Comment from Another File . . . . . . .     7
  147.           F6 = Import Zip Comments from a File  . . . . . .     8
  148.           ZCE Import settings file  . . . . . . . . . . . .     8
  149.           Import Commands . . . . . . . . . . . . . . . . .     8
  150.           Import Settings Filename  . . . . . . . . . . . .     8
  151.           Import Comments Filename  . . . . . . . . . . . .     9
  152.           Import Starting Comment Column  . . . . . . . . .     9
  153.           Import Edit/Auto  . . . . . . . . . . . . . . . .     9
  154.           Import Comment Search Tagged/All  . . . . . . . .     9
  155.           Import Editing Commands . . . . . . . . . . . . .     9
  156.           F7 = Volume Label . . . . . . . . . . . . . . . .    10
  157.           F8 = Dos Shell  . . . . . . . . . . . . . . . . .    10
  158.           F9 = Tag/Untag file for Import  . . . . . . . . .    10
  159.           F10 = Tad/Untag All Files . . . . . . . . . . . .    11
  160.           Escape = Exit ZCE . . . . . . . . . . . . . . . .    11
  161.           Tab = Restore Comment . . . . . . . . . . . . . .    11
  162.           Shift-F1 = Display ZCE variable status  . . . . .    11
  163.           Shift-F2 = Tag Files with Blank Comments  . . . .    11
  164.           Using ZD <Zip Directory>  . . . . . . . . . . . .    12
  165.           ZD Command Line Examples  . . . . . . . . . . . .    12
  166.           ZD Command line switches  . . . . . . . . . . . .    12
  167.           ZD Command Line Display Options . . . . . . . . .    13
  168.           ZD Command Line Color Options . . . . . . . . . .    13
  169.           ZD Command Line Sorting Options . . . . . . . . .    13
  170.           ZD Pause Control Options  . . . . . . . . . . . .    13
  171.           ZD Environment Variable . . . . . . . . . . . . .    14
  172.           ACKNOWLEDGEMENTS  . . . . . . . . . . . . . . . .    15
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.           Basic Libraries . . . . . . . . . . . . . . . . .    15
  184.           Future Versions of ZCE & ZD . . . . . . . . . . .    16
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237. 1.1 - What are ZCE and ZD?                                           Page 1
  238. ---------------------------------------------------------------------------
  239.  
  240.  
  241. 1.1  What are ZCE and ZD?
  242.  
  243.          Have you ever looked in a directory or a diskette and wondered
  244.          what was in those zip files?  I have on many occasions.  That's
  245.          why I created ZCE and ZD.
  246.  
  247.          ZCE and companion program ZD allow easy editing and displaying of
  248.          zip comments.  Once zip comments are added to zip files, you will
  249.          never have to unzip them to know what programs are inside.  You
  250.          won't have to unzip them and look for the infamous readme or .doc
  251.          file to find out what the programs are inside.  I found this very
  252.          time consuming and usually found that this zip file was not the
  253.          program I was looking for anyway.  Once zip comments are added ,
  254.          some disk cataloging programs can automatically read these
  255.          comments and add them to disk catalog reports.  ZD will quickly
  256.          display any comments found in your zip files.
  257.  
  258.          (1)PKZIP is just to time consuming when adding zip comments to
  259.          many zip files.
  260.  
  261.          What are zip's and what are zip comments anyway?  PKZIP is a
  262.          program that reduces all file types to compacted binary form and
  263.          stores as many files as you want in one file.  This is great for
  264.          upload/downloading via modem from work or Bulletin Board Systems.
  265.          Please find/download or borrow find out about PKZIP.  It may be
  266.          the most widely used program on pc's today.  It certainly saves
  267.          lots of disk space.  I encourage you to read the documentation
  268.          included with PKZIP.
  269.  
  270.          PKZIP allows comments to be stored inside of zip files.  This
  271.          allows users to add information about the programs inside or any
  272.          other information.  You may see the zip comments displayed in the
  273.          form of advertisements when unzipping a zip file.  This is the
  274.          main use on BBS's today.  ZCE and ZD are not for BBS SYSOP's to
  275.          store adds in zip files, but for everyday users to store important
  276.          information in the zip comment.
  277.  
  278.          (1)PKZIP Is a registered trademark of PKWARE Inc.
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294. ---------------------------------------------------------------------------
  295. ZCE & ZD v1.1 Users' Manual                      1.1 - What are ZCE and ZD?
  296. Page 2                                          ZCE & ZD v1.1 Users' Manual
  297. ---------------------------------------------------------------------------
  298.  
  299.  
  300. 1.2  ZCE Features
  301.  
  302.          Display and edit zip comments
  303.          Save comments into zip files
  304.          On line help
  305.          Re-read zip comments
  306.          Copy comment from another file
  307.          Import comments from external file
  308.          Modify floppy volume labels
  309.          Shell to dos
  310.          Tag/Untag files for import of comments
  311.          EGA/VGA 43/50 line support
  312.  
  313.  
  314. 1.3  ZD Features
  315.  
  316.          Companion program to ZCE
  317.          Quickly display file names and zip comments
  318.          Display file date, time, size and zip comment
  319.          Color options
  320.          File sorting options
  321.          EGA/VGA 43/50 line support
  322.  
  323.  
  324. 1.4  Limitations of ZCE and ZD
  325.  
  326.          Current limit is set to 500 files in any one directory depending
  327.          on the file specification entered.
  328.  
  329.  
  330. 1.5  ZCE & ZD System Requirements
  331.  
  332.          ZCE and ZD have been designed to work properly on the (*)IBM-PC,
  333.          IBM-XT, IBM-AT, PS/2, and any close compatible.  ZCE and ZD
  334.          require about 256K of ram to execute.  ZCE and ZD require PC/MS
  335.          DOS version 2.1 or later.
  336.  
  337.          * IBM-PC, IBM-XT, IBM-AT are trademarks of International Business
  338.          Machines Corporation, Boca Roton, Florida.
  339.  
  340.  
  341. 1.6  ZCE & ZD Document Information
  342.  
  343.          This document has been formatted to 59 lines per page.
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353. ---------------------------------------------------------------------------
  354. 1.6 - ZCE & ZD Document Information                  ZCE & ZD Users' Manual
  355. 1.7 - Using ZCE <Zip Comment Editor>                                 Page 3
  356. ---------------------------------------------------------------------------
  357.  
  358.  
  359. 1.7  Using ZCE <Zip Comment Editor>
  360.  
  361.  
  362. 1.7.1  ZCE Command Line Examples
  363.  
  364.          ZCE
  365.  
  366.          By itself on the command line will search the current directory
  367.          for *.zip and display one screen of filenames and comments sorted
  368.          by filename.
  369.  
  370.  
  371.          ZCE FOO*
  372.  
  373.          ZCE will search for FOO*.ZIP in the current directory
  374.  
  375.  
  376.          ZCE A:
  377.  
  378.          ZCE will search drive a: for *.zip
  379.  
  380.          ZCE C:\DOS
  381.  
  382.          ZCE will search for a directory called DOS.  If the directory DOS
  383.          exists then ZCE will search for C:\DOS\*.ZIP.  If the directory
  384.          does not exist then ZCE will look for the filename of DOS.
  385.  
  386.          Once ZCE determines that the input filename specification is legal
  387.          ZCE will display a window showing the zip files being searched for
  388.          comments.
  389.  
  390.          Escape may be pressed to interrupt ZCE while reading comments.  A
  391.          query box will be displayed to continue reading zip comments.
  392.          Valid responses are:
  393.  
  394.          Y/N for Yes or No Arrow keys move highlighted response, Enter
  395.          selects Left mouse button click on item if an mouse is detected.
  396.  
  397.          ZCE will display an error message if the command line arguments
  398.          are invalid or if there is a problems opening or reading the files
  399.          found.  The error will indicate the problem.
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412. ---------------------------------------------------------------------------
  413. ZCE & ZD v1.1 Users' Manual            1.7 - Using ZCE <Zip Comment Editor>
  414. Page 4                                          ZCE & ZD v1.1 Users' Manual
  415. ---------------------------------------------------------------------------
  416.  
  417.  
  418. 1.7.2  ZCE Command line switches
  419.  
  420.          Entering ZCE /? displays the following screen:
  421.  
  422.          Zip Comment Editor Syntax is ZCE <drive:\path\filenames>
  423.          [/options]
  424.  
  425.          Drive must be a Valid Dos Drive, i.e. A: or B: or C:
  426.          Path must be in Valid Dos syntax, i.e. \dos\ or \wp50\letters\
  427.          Filenames may contain Wildcards, i.e. *.ZIP or H?
  428.  
  429.          Options:
  430.          /?   = This Help Screen         /NS = No Save and Restore Screen
  431.          /EGA = Display 43/50 lines      /M  = Monochrome
  432.          /NC  = No Clock                 /A  = Alternate Color Set
  433.  
  434.  
  435. 1.7.3  ZCE Command Line Display Options
  436.  
  437.          /?        Display command line switches
  438.          /NS       Do not restore original dos screen
  439.          /EGA      Display 43/50 lines if EGA or VGA detected.
  440.          /M        Force monochrome display
  441.          /NC       Do not display clock at top of screen
  442.          /A        Display using alternate color set
  443.  
  444.          both / and - may be used for ZCE and ZD command line switches.
  445.  
  446.  
  447. 1.7.4  ZCE Environment Variable
  448.  
  449.          All ZCE command line switches may be added to the ZCE environment
  450.          variable.  This will allow you to set defaults for ZCE without the
  451.          hassle of entering them each time.  The ZCE environment variable
  452.          will be added to the switches on the command line.  If a error
  453.          occurs while entering an environment variable please consult your
  454.          dos manual for instruction on increasing your environment size.
  455.  
  456.          Entering the line SET ZCE=/ega /m for example will have the same
  457.          effect as entering these switches on the command line.  If ZCE is
  458.          executed by entering ZCE alone on the command line the effective
  459.          command will be ZCE *.zip /ega /m.
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471. ---------------------------------------------------------------------------
  472. 1.7 - Using ZCE <Zip Comment Editor>                 ZCE & ZD Users' Manual
  473. 1.8 - Example ZCE Screen                                             Page 5
  474. ---------------------------------------------------------------------------
  475.  
  476.  
  477. 1.8  Example ZCE Screen
  478.  
  479.  
  480.                                   Date      Disk Space   Volume Label
  481.                                    |            |            |
  482.                           Version  |    Time    |   Drive    |     Monitor
  483.                              |     |     |      |     |      |        |
  484.      |-------------------------------------------------------------------|
  485.      | Zip Comment Editor, v1.1 5/10/91 7:02am 350K   A:   BASIC     EGA |
  486.      |-------------------------------------------------------------------|
  487.      |DOCUMENT.ZIP|This is a set of documents to be reviewed later.      |
  488.      |FILENAME.ZIP|This is a zip COMMENT...........................      |
  489.      |OTHER.ZIP   |$$$ Could not find zipfile comment, may be bad zipfile|
  490.      |            |                                                      |
  491.      |            |                                                      |
  492.      |            |                                                      |
  493.      |            |                                                      |
  494.      |            |                                                      |
  495.      |            |                                                      |
  496.      |-------------------------------------------------------------------|
  497.      |F1=Help F2=Read F3=Write F4=File F5=Copy F6=Import F7=Vol F8=Dos...|
  498.      |-------------------------------------------------------------------|
  499.  
  500.  
  501.          ZCE will display the names of zip files being scanned for comments
  502.          or an error message if a problem occurs.  ZCE will display in
  503.          color or monochrome and will display 25, 43 or 50 lines depending
  504.          on the current mode of the graphics card.  ZCE will automatically
  505.          tag all files with blank comments for the import comments
  506.          function documented later.
  507.  
  508.          All zip files detected will be displayed on the left side with zip
  509.          comments on the right.  The comment will have all control
  510.          characters removed and truncated to 65 characters.  If you want to
  511.          preserve any zip comment, simply do not edit the comment.  ZCE
  512.          will only write modified comments.
  513.  
  514.          If ZCE had trouble locating the zip comment, the message: "$$$
  515.          Could not find zipfile comment, may be bad zipfile $$$" will be
  516.          displayed as the comment.  Bad zip file comments may not be edited
  517.          and not saved.  Either the zip file is corrupted or the zip
  518.          comment is very large.  Usually deleting the zip comment will
  519.          allow ZCE to read it correctly.  Use the -Z command in PKZIP to
  520.          delete the zip comment.  If you do this while in the dos shell
  521.          make sure you execute the re-read zip comments command <F2> when
  522.          you return to ZCE!!!  Make sure you have written out all modified
  523.          comments first!  See Shell to Dos command.  ZCE will check each
  524.          file size for any changes and display an error message if a change
  525.          is detected.  A Function key list will be displayed on the bottom
  526.          line of the screen.
  527.  
  528.  
  529.  
  530. ---------------------------------------------------------------------------
  531. ZCE & ZD v1.1 Users' Manual                        1.8 - Example ZCE Screen
  532. Page 6                                          ZCE & ZD v1.1 Users' Manual
  533. ---------------------------------------------------------------------------
  534.  
  535.  
  536. 1.9  ZCE Main Window Editing Keys
  537.  
  538.          Insert         Toggles the insert mode and over-type mode.
  539.          Delete         Delete character at cursor.
  540.          Backspace      Destructive backspace.
  541.          Left Arrow     Move the cursor to the left.
  542.          Right Arrow    Move the cursor to the right.
  543.          Home           Move the cursor to the beginning of the field.
  544.          End            Move the cursor to the end of the field.
  545.          Ctrl-Home      Move cursor to the start and erase the field.
  546.          Ctrl-End       Erase from the cursor to the end of the field.
  547.          Ctrl-BkSpace   Erase from the cursor to the start of the field.
  548.          Escape         Returns comment to its original text.
  549.          Alt-Home       Scroll to top comment.
  550.          Alt-End        Scroll to bottom comment.
  551.          Tab            Restore comment, until up/down move.
  552.  
  553.  
  554. 1.10  ZCE Commands
  555.  
  556.  
  557. 1.10.1  F1 = On Line Help Window Functions
  558.  
  559.          ZCE will display up to 256 lines of the file ZCE.HLP or as much of
  560.          this file as there is string space.
  561.  
  562.          F1             Help
  563.          Home           Beginning of help.
  564.          End            End of help.
  565.          PgDn           Next help page.
  566.          PgUp           Previous help page.
  567.          Escape         Exits help.
  568.  
  569.  
  570. 1.10.1.1  Mouse Help Window Functions
  571.  
  572.          Previous Page  Click mouse button between up arrow and scroll bar
  573.                         position marker.
  574.  
  575.          Next Page      Click mouse button between down arrow and scroll
  576.                         bar position marker.
  577.  
  578.          Move Pointer   The position marker in the scroll bar approximates
  579.                         the position within the help array.  To move to
  580.                         another relative position, place mouse cursor on
  581.                         scroll bar position marker, hold left mouse button,
  582.                         move to desired area on scroll bar, and release
  583.                         mouse button.
  584.  
  585.  
  586.          First Page     Click mouse on up arrow.
  587.  
  588.  
  589. ---------------------------------------------------------------------------
  590. 1.10 - ZCE Commands                                  ZCE & ZD Users' Manual
  591. 1.10 - ZCE Commands                                                  Page 7
  592. ---------------------------------------------------------------------------
  593.  
  594.  
  595.  
  596.          Last Page      Click mouse on down arrow.
  597.  
  598.          Exit           Move mouse cursor to the top-left corner of the
  599.                         window and press the left mouse button.
  600.  
  601.          Scroll bar     scroll bar approximates the position within the
  602.                         help array.  To move to array.  To move to another
  603.                         relative position, place mouse place mouse cursor
  604.                         on scroll bar position marker, hold left marker,
  605.                         hold left mouse button, move to desired area on
  606.                         desired area on scroll bar, and release mouse
  607.                         button.
  608.  
  609.  
  610. 1.10.2  F2 = Re-Read Zip Comments
  611.  
  612.          This command causes ZCE to read Comments from zip files using the
  613.          current drive, path and file specifications.  To change the file
  614.          specification, see F4.
  615.  
  616.  
  617. 1.10.3  F3 = Write Zip Comments
  618.  
  619.          This command writes any modified comment to the file from the
  620.          drive and path it was read from.  Any errors encountered will
  621.          cause ZCE to display a error message of the problem.  ZCE verifies
  622.          all data writes and checks all file sizes for changes before
  623.          writing.  ZCE will not change file dates or times.  ZCE will then
  624.          ask if you want to exit.
  625.  
  626.  
  627. 1.10.4  F4 = New File Specification & Read Comments
  628.  
  629.          An input window will pop up requesting a new file specification.
  630.          ZCE will then check this entry and give errors if the input could
  631.          not be parsed or if no files could be found.  Wildcard characters
  632.          are accepted.  i.e. * or *.zip or c:\dos\app?  are all valid
  633.          examples.  ZCE will display an error if an invalid drive, path or
  634.          file specification are entered.  Entering escape will cancel this
  635.          command.  The same rules apply here as the command line file
  636.          specification when starting ZCE.
  637.  
  638.  
  639. 1.10.5  F5 = Copy Comment from Another File
  640.  
  641.          If more than one file comment is available in the main ZCE window
  642.          then ZCE will pop up a list of current comments which may be used
  643.          for the current file comment.  Use the arrow keys and press enter
  644.          to select.  Escape will abort this command.  Home/End keys will
  645.          move highlight bar to the first/last items in the list.  If a
  646.  
  647.  
  648. ---------------------------------------------------------------------------
  649. ZCE & ZD v1.1 Users' Manual                             1.10 - ZCE Commands
  650. Page 8                                          ZCE & ZD v1.1 Users' Manual
  651. ---------------------------------------------------------------------------
  652.  
  653.  
  654.          mouse is detected the mouse pointer will be displayed.  Move the
  655.          mouse pointer to an item and select using the left button.
  656.  
  657.  
  658. 1.10.6  F6 = Import Zip Comments from a File
  659.  
  660.  
  661.  
  662. 1.10.6.1  ZCE Import settings file
  663.  
  664.          Example import screen:
  665.  
  666.           Import Settings Filename: ZCE.SET
  667.  
  668.                  Comments Filename: BBS.LOG
  669.  
  670.            Starting Comment Column: 30
  671.  
  672.          Comment Search, Edit/Auto: E
  673.  
  674.                 Search, Tagged/All: T
  675.  
  676.  
  677. 1.10.6.2  Import Commands
  678.  
  679.           F1       Help
  680.           F2       Set Import buffer size, (32-256).  Default is 256.
  681.           F8       Save Settings file
  682.           F9       Read Settings file
  683.          F10       Start Import
  684.          Esc       Abort Import function
  685.  
  686.          The Import buffer size is the number on lines used as the import
  687.          buffer for (E)dit comment searches only.  If there is not enough
  688.          string space available ZCE will display an error message.
  689.          Reducing the number of zip files or reducing the import buffer
  690.          size may allow ZCE to perform the import.
  691.  
  692.  
  693. 1.10.6.3  Import Settings Filename
  694.  
  695.          The file ZCE.SET contains the default import settings.  ZCE will
  696.          search the current directory and all directories in the Dos Path
  697.          for the file ZCE.SET and if not found an error message will be
  698.          displayed and default values will be assigned.
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707. ---------------------------------------------------------------------------
  708. 1.10 - ZCE Commands                                  ZCE & ZD Users' Manual
  709. 1.10 - ZCE Commands                                                  Page 9
  710. ---------------------------------------------------------------------------
  711.  
  712.  
  713. 1.10.6.4  Import Comments Filename
  714.  
  715.          This is the filename of the file containing the comments for
  716.          import.
  717.  
  718.  
  719. 1.10.6.5  Import Starting Comment Column
  720.  
  721.          This number should indicate the starting column of the comment
  722.          inside the comments file.  This option is only used for (A)UTO
  723.          mode.
  724.  
  725.  
  726. 1.10.6.6  Import Edit/Auto
  727.  
  728.          This is the import type.  E for EDIT and A for Automatic.  ZCE can
  729.          read single line comments from a file in AUTOMATIC mode or up to
  730.          240 characters into a small line editor in EDIT mode.
  731.  
  732.          AUTOMATIC mode searches the Comments file for a line containing
  733.          the filename portion like DOCS in DOCS.ZIP.  This allows the ZCE
  734.          to find comments in all type of BBS (Bulletin Board System) file
  735.          listings.  ZCE will use the comment found on the first line that
  736.          contains the filename string.  This may not be the correct
  737.          comment.  Make sure you check the comments after ZCE is finished.
  738.  
  739.          In EDIT mode (default) ZCE will pop up a line editor with three
  740.          lines of data starting on the line that the filename is located.
  741.          You can now edit the comment to your liking.  Just remember that
  742.          the finished comment must be no longer than 65 characters long.
  743.          ZCE will truncate longer comments.  A marker is displayed at
  744.          column 65 to indicate where truncation will occur.
  745.  
  746.  
  747. 1.10.6.7  Import Comment Search Tagged/All
  748.  
  749.          Importing of comments may be performed on tagged or all files.
  750.          ZCE will only search for comments of tagged files if T is entered.
  751.          T is the default.  This will speed up comment imports.
  752.  
  753.  
  754. 1.10.6.8  Import Editing Commands
  755.  
  756.          All editing commands are the same as the main ZCE window with
  757.          addition of the following:
  758.  
  759.          F1        Help
  760.  
  761.          Esc       Skip the current comment and will keep the current
  762.                    filename on the search list.
  763.  
  764.  
  765.  
  766. ---------------------------------------------------------------------------
  767. ZCE & ZD v1.1 Users' Manual                             1.10 - ZCE Commands
  768. Page 10                                         ZCE & ZD v1.1 Users' Manual
  769. ---------------------------------------------------------------------------
  770.  
  771.  
  772.          Enter     Accept, Truncates the current comment to 65
  773.                    characters and removes the filename from the search
  774.                    list.
  775.  
  776.          Ctrl-Enter
  777.  
  778.                    Abort, Terminate Import function.  ZCE will ask if
  779.                    you really want to Abort.  ZCE will still use all
  780.                    previously found comments even if Abort is selected.
  781.  
  782.          Tab       Tab will Restore the comment to it's original form just
  783.                    in case you made a mistake.
  784.  
  785.  
  786. 1.10.7  F7 = Volume Label
  787.  
  788.          If the current or selected drive is A: or B: then ZCE will pop up
  789.          an input window for the new volume label.  Only 11 characters will
  790.          be allowed.  ZCE will only allow characters that are valid for
  791.          volume labels.
  792.  
  793.  
  794. 1.10.8  F8 = Dos Shell
  795.  
  796.          Spawns another Command.Com leaving ZCE in memory.  About 200K is
  797.          used by ZCE.  If the system crashes or is re-booted all editing of
  798.          comments will be lost unless saved.
  799.  
  800.          The prompt is modified to remind you to type EXIT to return to
  801.          ZCE.
  802.  
  803.          Enter 'EXIT' to Return to ZCE
  804.          C:\QB\ZCE>
  805.  
  806.          If you Shell to Dos and modify a zip file in any way, the comment
  807.          address will be altered and ZCE will display an error message and
  808.          not write data to the file.  When ever you return to ZCE from the
  809.          shell always re-read the zip file comments using the <F2> key if
  810.          any zip file were modified.  Make sure you write out any modified
  811.          comments first!  This will update comment positions to ZCE and
  812.          allow correct comment update.
  813.  
  814.  
  815. 1.10.9  F9 = Tag/Untag file for Import
  816.  
  817.          This function will tag or Untag a file.  The Import function
  818.          allows importing comments for all or tagged files.
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825. ---------------------------------------------------------------------------
  826. 1.10 - ZCE Commands                                  ZCE & ZD Users' Manual
  827. 1.10 - ZCE Commands                                                 Page 11
  828. ---------------------------------------------------------------------------
  829.  
  830.  
  831. 1.10.10  F10 = Tad/Untag All Files
  832.  
  833.          All files will be tagged or untagged.
  834.  
  835.  
  836. 1.10.11  Escape = Exit ZCE
  837.  
  838.          A message will be displayed asking if you would like to exit ZCE.
  839.          Default is NO.  Arrow keys move between No and YES.  The enter key
  840.          will select.  Y or N will also select.  If you have a mouse the
  841.          left button may be used to click on the Y or N.
  842.  
  843.  
  844. 1.10.12  Tab = Restore Comment
  845.  
  846.          This command will restore the current comment only if the cursor
  847.          is not moved to another comment.  i.e. up or down.
  848.  
  849.  
  850. 1.10.13  Shift-F1 = Display ZCE variable status
  851.  
  852.          This command will display the internal ZCE variables.  This
  853.          command is mainly used for development of ZCE.  I am documenting
  854.          this just in case you run into it.
  855.  
  856.  
  857. 1.10.14  Shift-F2 = Tag Files with Blank Comments
  858.  
  859.          This command will tag all files with blank comments and untag
  860.          files with comments.
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884. ---------------------------------------------------------------------------
  885. ZCE & ZD v1.1 Users' Manual                             1.10 - ZCE Commands
  886. Page 12                                         ZCE & ZD v1.1 Users' Manual
  887. ---------------------------------------------------------------------------
  888.  
  889.  
  890. 1.11  Using ZD <Zip Directory>
  891.  
  892.  
  893. 1.11.1  ZD Command Line Examples
  894.  
  895.          ZD /?
  896.          Display help screen
  897.  
  898.          ZD /w /sf
  899.          Display in wide format and sort by filename
  900.  
  901.          ZD *.zip /ega /ss /zc=7,1 /np
  902.          Display all files with .zip extension, in 43 or 50 line mode, sort
  903.          by file size, show zip comments in white on blue and do not pause.
  904.  
  905.  
  906. 1.11.2  ZD Command line switches
  907.  
  908.          Entering ZD /? will display this help information:
  909.  
  910.          Zip Directory syntax: <Drive:\Path\Filenames> [/options]
  911.  
  912.          Drive must be a Valid Dos Drive, i.e. A: or B: or C:
  913.          Path must be in Valid Dos syntax, i.e. \dos\ or \wp50\letters\
  914.          Filenames may contain Wildcards, i.e. *.ZIP or H?.WP
  915.  
  916.          Options:
  917.          /?  = This Help Screen           /W  = Wide Format, date and time
  918.          /NP = No Pause for Full Display  /NS = No Save and Restore Screen
  919.          /EGA = Display 43/50 lines       /M  = Monochrome
  920.  
  921.          Color Options:
  922.          #,# is foreground(0 to 15),background(0 to 7), No Spaces Allowed
  923.          /ZF=#,#   = ZIP filename Colors     /ZC=#,#   = ZIP Comment Colors
  924.          /OF=#,#   = Other Filename Colors   /TC=#,#   = Text Colors
  925.          /HC=#,#   = Header Colors           /BG=#     = Background Color
  926.          /A        = Use alternate color set
  927.  
  928.          Sorting Options:
  929.          /SF = Filename, /SS = Size, /SE = Extension, /SD = Date
  930.  
  931.          B =Backup listing, N = Read new disk
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943. ---------------------------------------------------------------------------
  944. 1.11 - Using ZD <Zip Directory>                      ZCE & ZD Users' Manual
  945. 1.11 - Using ZD <Zip Directory>                                     Page 13
  946. ---------------------------------------------------------------------------
  947.  
  948.  
  949. 1.11.3  ZD Command Line Display Options
  950.  
  951.          /?        Display Help Screen
  952.          /W        Wide Format, Shows date, time and file size.  The zip
  953.                    comment is displayed on the next line.
  954.          /NP       No Pause for full screen
  955.          /NS       No Save and Restore Screen
  956.          /EGA      Display 43/50 lines if EGA/VGA detected
  957.          /M        Force monochrome display
  958.  
  959.  
  960. 1.11.4  ZD Command Line Color Options
  961.  
  962.          /ZF=#,#   Zip filename colors
  963.          /ZC=#,#   Zip comment colors
  964.          /OF=#,#   Other filename colors
  965.          /TC=#,#   Text colors
  966.          /HC=#,#   Header colors
  967.          /BG=#     Background color
  968.          /A        Alternate color set
  969.  
  970.          #,#=foreground(0 to 15),background(0 to 7), No Spaces Allowed.
  971.  
  972.          0    black                    8    grey
  973.          1    blue                     9    light blue
  974.          2    green                    10   light green
  975.          3    cyan                     11   light cyan
  976.          4    red                      12   light red
  977.          5    magenta                  13   light magenta
  978.          6    brown                    14   yellow
  979.          7    white                    15   bright white
  980.  
  981.  
  982. 1.11.5  ZD Command Line Sorting Options
  983.  
  984.          /SF       Sort by Filename
  985.          /SS       Sort by Size
  986.          /SE       Sort by Extension
  987.          /SD       Sort by Date
  988.  
  989.  
  990. 1.11.6  ZD Pause Control Options
  991.  
  992.          B         Backup listing
  993.          N         Re-read disk again.  Good for reading a new disk without
  994.                    having the run ZD again.
  995.          Escape    Quit ZD
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002. ---------------------------------------------------------------------------
  1003. ZCE & ZD v1.1 Users' Manual                 1.11 - Using ZD <Zip Directory>
  1004. Page 14                                         ZCE & ZD v1.1 Users' Manual
  1005. ---------------------------------------------------------------------------
  1006.  
  1007.  
  1008. 1.11.7  ZD Environment Variable
  1009.  
  1010.          All ZD command line switches may be added to the ZD environment
  1011.          variable.  This will allow you to set defaults for ZD without the
  1012.          hassle of entering them each time.  The ZD environment variable
  1013.          will be added to the switches on the command line.  If a error
  1014.          occurs while entering an environment variable please consult your
  1015.          dos manual for instruction on increasing your environment size.
  1016.  
  1017.          Equal signs "=" are not allowed in environment settings, therefore
  1018.          the pound sign "#" must be used as a substitute character.
  1019.          Instead of entering /zc=0,3 you must enter /zc#0,3.
  1020.  
  1021.          Entering the line SET ZD=/ega /m for example will have the same
  1022.          effect as entering these switches on the command line.  If ZD is
  1023.          executed by entering ZD alone on the command line the effective
  1024.          command will be ZD *.* /ega /m.
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061. ---------------------------------------------------------------------------
  1062. 1.11 - Using ZD <Zip Directory>                      ZCE & ZD Users' Manual
  1063. 1.12 - ACKNOWLEDGEMENTS                                             Page 15
  1064. ---------------------------------------------------------------------------
  1065.  
  1066.  
  1067. 1.12  ACKNOWLEDGEMENTS
  1068.  
  1069.          Special Thanks to Phil Katz of PKWARE for releasing the zip file
  1070.          formats.  Without this many utilities like ZCE and ZD could not be
  1071.          possible.
  1072.  
  1073.  
  1074. 1.13  Basic Libraries
  1075.  
  1076.          Here is a list of the QuickBasic Libraries and programming aids
  1077.          used to create ZCE and ZD.
  1078.  
  1079.          PBCLONE (Pro Bas Clone) by Thomas G. Hanlin III
  1080.          3544 E.  Southern Ave.  #104
  1081.          Mesa, AZ 85204
  1082.  
  1083.          MicroHelp ToolBox, QB/Pro Volumes 1-4 and Mach 2
  1084.          4636 Huntridge Drive
  1085.          Rosewell, Georgia 30075
  1086.          (404) 552-0565
  1087.  
  1088.          QB4BAS Version 4.6 by Harold Thomson
  1089.          7437 Burnway Drive
  1090.          Orlando, Florida 32819
  1091.          (407) 351-3737
  1092.  
  1093.          Quick Windows Shareware version 1.2 by Software Interphase Inc.
  1094.          5 Bradley Street
  1095.          Providence, RI 02908-2304
  1096.          (401) 274-5465
  1097.  
  1098.          Basic Window Tools Version 8.0 by James P. Morgan
  1099.          5226 Via Hacienda #115
  1100.          Orlando, Florida 32809
  1101.  
  1102.          The QBNews International QuickBasic Electronics Newsletter.
  1103.          By Clearware Computing
  1104.          P.O. Box 507
  1105.          Sandy Hook, CT 06482
  1106.  
  1107.          QBNews is available for download from Microhelp BUG BBS (404)
  1108.          552-0567 or Crescent Software BBS (203) 426-5958.
  1109.  
  1110.          All libraries listed above are available to all registered users
  1111.          from the Vanguard BBS, (408) 988-0288.
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120. ---------------------------------------------------------------------------
  1121. ZCE & ZD v1.1 Users' Manual                          1.13 - Basic Libraries
  1122. Page 16                                         ZCE & ZD v1.1 Users' Manual
  1123. ---------------------------------------------------------------------------
  1124.  
  1125.  
  1126. 1.14  Future Versions of ZCE & ZD
  1127.  
  1128.          Color Configuration
  1129.          Longer Comment Editing
  1130.          Improved Documentation
  1131.          Other archive types
  1132.  
  1133.          Please send comments and enhancement suggestions!!!!
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179. ---------------------------------------------------------------------------
  1180. 1.14 - Future Versions of ZCE & ZD                   ZCE & ZD Users' Manual
  1181.